DirectAudio Player Installation Instructions +--------------------------------------------------------------------------------------------+ Installation Instructions - Create a new directory and Download the DirAudio.Zip file. - Unzip the file in the created directory. - Run the INSTALL.EXE utility OR - Move (not copy) the ctl3dv2.dll file in your system's \windows\system directory after having made sure that you are not replacing an earlier version of it. (In the case you had an earlier version of ctl3dv2.dll, keep this one, delete the one shipped with DAP) - Move BWCC.DLL to you \Windows directory. - Move the TCP4W.DLL to your system's \windows directory +--------------------------------------------------------------------------------------------+ File Manager To have the file manager launch DAP when selecting a WAV, AU and GSM file: - Open Window's file manager. - Select File|Associate - File With Extension: WAV - Associate with: [path]\DirAudio.EXE - Do the same operations for AU and GSM extensions. +--------------------------------------------------------------------------------------------+ WWW Browser To have your internet browser launch DirAudio after a link to a GSM, GSD, WAV or AU file has been selected: - Add a new MIME Type definition for GSM6.10 in your WWW browser: audio/x-gsm - Set file extension for this type as gsm - Select DirAudio.EXE as the application launched when receiving audio/x-gsm media type. For Netscape: - Select Options|General Preferences|Helpers - Click on the "Create New Type" button. MIME TYPE: audio MIME SUBTYPE: x-gsm -Set File Extension as: gsm,gsd - Select the "Launch Application" radio button. - Enter the pathname of DirAudio.EXE Example: c:\diraudio\diraudio.exe - Press the "OK" button. Repeat the same procedure for WAV Edit existing audio/x-wav type or Click on the "Create New Type" button. MIME TYPE: audio MIME SUBTYPE: x-wav Set File Extension as: wav Same as step 5 and 6 above. Repeat the same procedure for .AU Edit existing audio/basic type or Click on the "Create New Type" button. MIME TYPE: audio MIME SUBTYPE: basic Set File Extension as: au,snd Same as step 5 and 6 above. Note: The helper application definition for audio/basic is usually occupied by Netscape's audio player app. NAPLAYER.EXE. In this case all you need to do is to edit that entry. Just select the "Browse" button and select DirAudio.EXE. +--------------------------------------------------------------------------------------------+ Adding GSM file support on a WWW server. The HTTP (WWW) server must be set up to accept the GSM file type (Extension: .GSM). This is done by adding a new MIME type definition to the server (usually in a configuration file). The new MIME type to add is: TYPE/SUB-TYPE EXTENSION audio/x-gsm gsm, gsd The procedure to add a new MIME type varies from one server to another but is quite straightforward and should not cause any major headaches to your server maintenance peoples or your service provider. If you are using the services of a provider and in the unlikely event that he would refuse to do it (doubtfull) you will have find another server to put your sound files or find a more cooperative service provider. The .gsd extension is used for the real time streaming audio description files. +--------------------------------------------------------------------------------------------+ Listening to real time Audio There are two methods of accessing a GSM file from a HTTP (WWW) server: First, by selecting the File|Open Location option on the main menu and entering the full URL of the file you wish to fetch. For instance: http://www.cam.org/~noelbou/ex1.gsm will fetch the example from my WWW site on my service provider's WWW server. (you can use your browser's Copy Location function (Right click on the link) and then paste it in DAP Open Location's dialog box by using ). Second, by clicking on a link to a "description file" on a WWW page. For instance: EX1.GSD will fetch the description file named ex1.GSD on my WWW site. IAP will be spawned by your WWW browser and the file will instruct the player on which GSM file to fetch from the net. +------------------------------------------------------------------------+ Publishing streaming Audio on a WWW server Publishing your audio files on the net is very simple. Here's the procedure. -Record you audio file or convert it to the proper format. You must start from a 8000 Hz 16 bits file or from an 8000 Hz 8bits "Mu-Law" encoded file (.AU) (Sun/Next). - Create you GSM file by using the Compress function of IAP. - Create a "Description File" with extension .GSD . This is a simple ASCII text file which contains a reference to the .GSM file that you want to give access to. This file should have the following form: GSM_URL|protocol://host[:port]/path/filename Where: protocol is for now fixed to: http host is the host where the file is located. path is the path to the file on the given host filename is the GSM file name (with extension .GSM) For instance: GSM_URL|http://www.cam.org/~noelbou/ex1.gsm or GSM_URL|http://itre.ncsu.edu/gsm/garotos.gsm Note that the referenced (.GSM) file may reside on any WWW server on the Internet. Check at: http://www.cam.org/~noelbou/gsm_wine.html and http://www.cam.org/~noelbou/gsmlinks.html for other explanations and examples. +-------------------------------------------------------------------------------------+ Notes: I included a few .GSD file to let you try the Streaming GSM6.10 features of DAP. These link were valid as of 6 June 1996 ... Some are in my WWW site, some others from the Internet Multicating Service etc ... You can play these by: - Open Windows file manager and drop the selected GSD file onto DAP window. (That is click on a GSD file and HOLD the mouse button and "drag" the selected file over DIA window). Setting the "Always on Top" option on is usefull here... - Uploading them to your WWW site and creating links to the GSD files on an HTML page that you create in your WWW site. - Use a text editor to cut and paste the URL in DAP's File | OpenLocation Input Box. Check our GSM links page at http://www.cam.org/~noelbou/gsmlinks.html